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(57) Abstract 

A system and method for preparing, using and displaying a state model of a process, as an industrial or business process, as a 
sequence of discrete steps. The state model defines the behavior of the logical objects making up a process model of the process as a set of 
permitted states and a set of permitted transitions between the permitted states. The method involves creating a state model <61) with certain 
parameters, a Create/Modify State Transition for a State Model (63) and Associate State Transition with Rules and Conditions (65). These 
rules are inputted into a graphical user interface which causes appropriate rules to be extracted from a database (67). They are assembled 
into a state machine execution engine (69) and implemented (70) to produce an enforced state model on targeted business objects t71) and 
the target business object is enabled <73). 
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STATE MODELS FOR MONITORING 
PROCESSES 

FIELD OF THE INVENTION 

This invention relates to state models and state model development for defining and 
monitoring processes, more specifically, for monitoring industrial and business 
processes. 

BACKGROUND 

As the business environment becomes more complex, with multiple, overlapping 
channels, competing and complementary paradigms, providing customized products 
to large numbers of customers, it becomes absolutely essential for the enterprise to 
bring its business processes under control. Control of the business process must be 
accomplished in such a way as to provide management with accurate and current 
knowledge of the state of business, including deals in progress, and their progression 
through the enterprise. 

There is an especially strong need for a readily scalable and readily deployable 
development environment, including development tools, to allow-end users to develop 
business applications customized to their needs and derived from supplied base 
classes, functions, subroutines, and the like. 

Likewise, in the industrial sector as industrial processes become longer and more 
complex, with parallel paths of discrete process steps, frequently carried xyut at 
different locations, leading to nodes, and to still further process steps. This has created 
a need for a readily scalable and readily deployable development environment to 
allow end users to develop industrial modeling applications derived from supplied 
classes, functions, routines, and subroutines. 

A particular need for programming tools is in the area of the representation of a 
process as a sequence of discrete, frequently parallel, steps, as in flow charts, and 
especially funnel charts. 
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A further need exists for development tools for the development of pipeline models, 
as industrial, manufacturing or sales pipeline models. 

5 A still further need exists for development tools for assistant modules, as industrial, 
manufacturing or sales assistant modules used to guide personnel through 
manufacturing sequences and sales transactions. 

SUMMARY OF THE INVENTION 

10 

Our invention relates to state models of "objects" and especially configurable state 
models of "objects." "Objects" which are referred to herein as "business objects" or as 
"objects" include sets of functions, and variables, characterized by permitted states 
and transitions, and prohibited states and transitions. The objects may model steps or 

15 states in a business process or in a manufacturing process. Objects may be called by 
an end-user, and incorporated into an end-user's programs, routines, subroutines, 
functions, and applets. According to our invention the "objects" are related to and/or 
are useful in one or more types of industrial and manufacturing processes, business 
transactions, and/or business processes, such as product fabrication, product 

20 assembly, warehousing, shipping, customer contacts, sales leads and referrals, orders, 
order configuration, and similar transactions. 

The invention provides a method of preparing a state model of a process, as an 
industrial or business process. The state model defines the behavior of logical 

25 industrial or business objects in an industrial or business process model of the 
industrial or business process as a set of permitted states and a set of permitted 
transitions between the permitted states. This is done through the steps of selecting a 
template for the state model; selecting industrial or business object components for 
the state model; selecting or defining state transitions for the state model; defining 

30 permitted state transitions from a "from state" to a "to state" with a State Transition 
Rule name; associating state transitions with state transition rules, names, and 
conditions; enumerating the state transition names and state transition rule names; and 
extracting the state transition rules from a database. The states, transitions, and 
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extracted rules make up a state machine execution engine; and process the industrial 
and/or business model through the state machine execution engine. 



At least one of the state transition rules include prerequisites which must be met 
5 before the transition is permitted, and at least one of the state transition rules define 
authorized users for effecting a state transition. 

In one embodiment of the invention the business objects define a manufacturing or 
sales pipeline funnel model (here illustrated as a sales pipeline) of a set of industrial 
10 processes or business deals (here illustrated as business deals), where the sales 

pipeline funnel shows business deals being worked in different methodologies on a 
single sales pipeline graphic. The methodologies are chosen from the, for example, 
telesales process deals, strategic deals, and standard process deals. 

IS In this embodiment of the invention the business deals may be grouped by sales 

methodology, and classified as, for example, as qualifying deals, working deals, and 
closing deals. Similarly, industrial processes may be grouped by technology, physical 
processes, equipment, or the like. 

20 In the case of business models, the method of the invention is practiced by creating a 
sales opportunity, creating a sales method, breaking the sales method into sales cycles 
within the sales method, and breaking the sales cycles down into sales phases for-each 
sales cycle. In the case of industrial models, the method of the invention is practiced 
by creating process flows, manufacturing steps, identifying manufacturing steps to 

25 manufacturing equipment or processes, and introducing testing and/or quality control 
steps. 

In carrying out the method of the invention a sales method is associated with a sales 
opportunity, and the sales opportunity is advanced based upon the associated sales 
30 method. Sales opportunities are sorted and grouped by at least one of sales methods, 
cycles, and phases. The deal data, grouped by one or more of sales method, sales 
cycle, and deal phase, to a charting engine, and from the charting engine to the Sales 
Pipeline Funnel Chart. 
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An aspect of the method of the invention is monitoring the state of deal or product as 
it moves from state to state, for example, to determine additional actions with respect 
to the deal or product. 

Another aspect of the invention is assigning activity and assessment templates to a 
deal or product in process, for example, to assess the deal or manufacturing process 
flow using the assigned activity and assessment templates. 

A further embodiment of our invention is a system running on at least one computer 
(but frequently on more then one computer, as a client and a server, or a web client 
and a web server and one or more application servers) for preparing a state model of a 
process as described above. The state model defines the behavior of logical business 
or industrial objects in a business or industrial process model of the process as a set of 
permitted states and a set of permitted transitions between the permitted states. The 
system is configured to: select a template for the state model; select object 
components for the state model; select or define state transitions for the state model; 
define permitted state transitions from a "from state" to a "to state" with a State 
Transition Rule name; associate state transitions with state transition rules, names, 
and conditions; enumerate the state transition names and state transition rule names; 
extract the state transition rules from a database; wherein the states, transitions, and 
extracted rules comprise a state machine execution engine; and process a business 
model through the state machine execution engine. 

In the system and method of our invention we provide a unique integration, through a 
state model and state machine of several objects, as industrial or business objects, to 
provide graphical reports, such as a Multiple Method Sales Pipeline, a Funnel Chart 
Engine, and a set of reporting tools. As a result, data, including sales pipe line data 
and industrial work-in-progress data, can be reported graphically across multiple sales 
methods and industrial methods and locations using such techniques as funnel 
charting, sales pipelines, and customized reporting techniques. 

The invention described herein includes a method and a system for preparing and 
using a state model of an industrial or business process. The state model defines the 
behavior of the logical objects making up a business process model of the business 
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process as (1) a set of permitted states and (2) a set of permitted transitions between 
the permitted states. The state model is created by selecting a template for the state 
model, and selecting industrial or business object components for the state model (for 
example, by using "OOP" or other programming paradigms and methods as described 
5 herein). The user then selects or defines state transitions for the state model, for 
example, by defining permitted state transitions from a "from state** to a "to state**. 
This is the "configurability** aspect of the state model. The defined or selected state 
transition rules are identified to State Transition Rule names. That is, state transitions 
are associated to specific state transition rules, names, and conditions, and the state 
10 transition names and state transition rule names are enumerated. The specific state 
transition rules corresponding to the names are extracted from a database. The 
extracted states, transitions, and rules define the state machine execution ^engine. This 
state machine execution engine is used to process business models, as described 
herein. 

15 

THE FIGURES 

The method and system of our invention may be understood with reference to the 
Figures. 

20 

Figure 1 illustrates a flow chart of the Configurable State Module of the method and 
system of our invention. 

Figure 2 shows the relations of the state model, and specifically, the state model, the 
25 state, the state transitions, the state transitions and positions, and the positions. 

Figure 3 illustrates a screen shot of the State Model view of our invention. 

Figure 4 illustrates a funnel chart engine representation of the method and system of 
30 our invention. 

Figure 5 illustrates a flow chart of the method and system of the multi-method sales 
pipeline module of our invention. 
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Figure 6 illustrates a flow chart of the Sales Assistant Module of the method and 
system of our invention. 

DETAILED DESCRIPTION OF THE INVENTION 

The system and method of our invention relate to "objects" including industrial and 
business objects, that are associated through a "configurable state model" having sets 
of permitted states and sets of permitted transitions to provide a manager with needed 
information, and with tools to extract, analyze, and display the information. This is 
accomplished through such business objects as an opportunity object, a sales method 
object, a multi-method sales pipeline object, and a funnel chart engine business 
object, as well as such industrial objects as manufacturing operations, manufacturing 
equipment, workflow, capacities, and the like. 

As pointed out above, "objects" include sets of functions, variables, routines, and 
subroutines and configurable state models. Objects may be called by an end-user, and 
incorporated into an end-user program, routines, and applets. According to our 
invention when the "objects" are business objects they related to and/or are useful in 
one or more types of business transactions and/or business processes, such as 
customer contacts, sales leads and referrals, orders, order configuration, and similar 
transactions. Similarly, when the "objects" are industrial objects they are related to 
and/or useful in one or more types of industrial, manufacturing, or warehousing 
processes. 

Our invention utilizes a configurable state model of processes. The configurable state 
model defines the behavior of the logical industrial or business objects, including 
functions and variables therein, making up an industrial or business process model of 
the industrial or business process as (1) a set of permitted states and (2) a set of 
permitted transitions between the permitted states. 

The Configurable State Model provides users with a data driven method for extending 
workflow control based on the status of an object. In order to make this work, users 
need to define the state model which consists of a set of acceptable states and state 
transitions. The state machine then ensures that these objects go through the desired 
process defined by the state model. 
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The configurable state model is created by selecting a template for the state model, 
and selecting business object components for the state model (for example, by using 
"OOP" methods, such as calling a member function with a calling object, using the 
5 C++ syntax Calling_Object.Member_Function (ArgumentJList) as described herein 
or the JAVA syntax, or by calling routines, subroutines, functions, and the like as in 
conventional programming paradigms, using, for example BASIC, FORTRAN, C, 
and the like). The user then selects or defines state transitions for the state model, for 
example, by defining permitted state transitions from a "from state" to a "to state", as 

10 by specifying arguments in the "ArgumentJList" of the called Member_Function. 
The defined or selected state transition rules are identified to State Transition Rule 
names. That is, state transitions are associated to specific state transition rules, names, 
and conditions, and the state transition names and state transition rule names are 
enumerated, using object oriented programming methodology. The specific state 

15 transition rules corresponding to the names are extracted from a database of -state 
transition rules. The extracted states, transitions, and rules define the state machine 
execution engine. This state machine execution engine is used to process business 
models, as described herein. 

20 In the configurable state model and associated applications of the method and system 
of our invention, we provide a unique integration of several business objects with an 
interactive synergy therebetween through the configurable state model. 

For example, in the Funnel Chart application of our invention, multiple streams of 
25 sales transactions and customers at different levels of completion can be integrated 
and the resulting sales pipeline data can be reported graphically across multiple sales 
methods using funnel charting technique. Similarly the Funnel Chart application of 
our invention can be used to graphically report industrial processes similar to the "N 
Server- M Queue" models. 

30 

The components that are associated in the system and method of the invention are: 

A state model which is a characterization of objects as a set of configurable state 
models, each configurable state model itself being a set of permitted states and 
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pennitted transitions between the permitted states, including permitted state 
transitions, prerequisites for transitions such that one cannot move into the next stage 
until the prerequisite is met, and actors that are permitted to move the process to a 
stage (e.g., only specific users may change the status of the object to "approved" or 
"closed.")- 

A funnel chart engine, as shown in Figure 4, that, given specific charting instructions, 
generates graphical chart based on the sales pipeline and sales methods. As shown in 
Figure 4, the funnel chart engine breaks deals up into classes, for example, qualifying 
deals, working deals, and closing deals. Within each class are categories of deals, 
such as telesales process deals, strategic deals, and standard process deals. 

An opportunity object which is a business object that keep information about a sales 
opportunity 

A sales method object which is a business object that allows a user to create and store 
data related to sales methodology, including sales cycles and phases. 

Related objects for industrial processes can include shop orders, equipment and 
process flow chart and sequencing parameter data, capacities, and the like. 

Specific Components of the System and method 
State Model 

Returning to the state model, the state model is part of the system and method of our 
invention. A state model is an abstraction of digital device where the present state 
(output state) of the model is a function of its immediately preceding state (input 
state) and of a binary control signal (input control signal). In a state model, the output 
state of the model is a unique function of the input state and the input control signal 
(0, 1). According to the system and method Of our invention, the "state model" 
works through a "state machine" with the business objects to define allowable state 
values, transitions, and paths. 
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The state model defines the behavior of logical objects, as industrial or business 
objects, as a set of states and transitions between states. In addition to defining the 
universe of permitted values and transitions, the state model allows administrators to 
define prerequisites for transitions such that one cannot move into the next stage until 
5 the prerequisite is met. 

The state model also defines authorized "users" (by title or by security access or the 
like) that are permitted to move the state model of a transaction or workpiece to a 
state. Only specific users may change the state of the object, for example by 

10 advancing it to the next state, or to "approved" or "closed." Moreover, the authority 
or power to change the state of an object may be function of both the user and the 
present state. For example, a manager may have the power to "approve" or 
disapprove" a deal at the nth state, but not when the deal reaches the n+lth state. 
Similarly, a manufacturing technician can divert a workpiece from the nth tool to the 

15 n+lth tool, but can not divert the workpiece further once it has reached the n+lth tool. 
"Position" as shown in blocks 70 ("State Transition/Position") and 75 ("Position") of 
Figure 2 defines the "user." 

The state model is the blueprint of acceptable states and state transitions that the state 
20 machine will enforce. The state machine then ensures that these objects go through 
the desired process defined in the state model. 

A state machine is an engine that enforces the transitions between states for an object 
during its lifetime. A state represents the status of an object, such as Open, Closed, 
25 Pending, and so on. The state represents where the object is in its lifetime. The "state 
machine can also control whether or not the data of that object can be modified or not. 
As an example, a Service Request that is in a Closed ^tate may be considered 
"frozen", such that its attributes cannot be modified. 

30 A state transition defines the allowable migration of an object from one state to the 
next. For instance, a Service Request that has been closed but must be re-opened may 
go from the Closed state to an Open state, and may go from Open to Pending, but may 
not transition directly from Closed to Pending. The allowable migration of a Service 
Request from Closed to Open, or Open to Pending, represents defined state 

9 
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transitions. The state transition can also enforce other behavior. The state transition 
definition can verify that specific conditions have been met before the transition 
occurs. The state transition definition can also control what individuals or groups of 
individuals can initiate the transition. 



Configurable State Models - Technical Description 

The Configurable State Model module illustrated in Figure 1 provides users with a 
data driven method for extending workflow control based on the status of an object. 
In order to make this work, users need to define the state model, which consists of a 
set of acceptable states and permitted state transitions. The state machine then 
ensures that these objects go through the desired process defined by the state model. 
According to the system and method of our invention, the configurable state model is 
used in the context of logical business objects. Specifically, state model states and 
transitions are defined for business objects using an intuitive user interface, with 
limitations put upon those who can transition objects from one state to another state. 
Figure 3 is a screen shot of the State Model view of our invention. 

The State Model consists of the following components: 

State: The state is the status of an object. This can also refer to the value of an 
attribute where the attribute will change values over the life of the object. Value can 
be Boolean, alphanumeric, or numeric. 

State Transition: A state transition is a linkage or set of linkages between two states 
that define the allowable migration from one state to the next. We can add the rule 
validations to a state transition and the state machine will determine can if we advance 
to the next state or not at run time. Also we can define who has the privilege to 
advance to the next state by defining the authorized users. 

State Model: The state model is the set or blueprint of allowable states and state 
transitions that the state machine will enforce. 
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State Machine. The State Machine is the engine that enforces the states and state 
transitions that an object may go through during its lifetime. 

As shown in Figures 1, 2, and 3, the first step in the method of our invention is to 
5 create a state model or modify an existing state model, block 61 of Figures 1 and 2 
and block 62 of Figure 2 where certain parameters ("State Model ID," "Value/' 
description"). This is illustrated in Figure 3 as the actions called for in the top block, 
that is, entering and/or selecting the "State Model," the "Business Component" of the 
"State Model", the "Field", and the activation and expiration dates. The next two steps 

10 are to "Create/Modify State Transition for a State Model" as illustrated in block 63 of 
Figures 1 and 2, and "Associate State Transition With Rules and Conditions" as 
shown in block 65. This is illustrated by block 65 of Figure 2 (where 44 State Model 
ID," "From State ID," "To State ID," "Field Name," "Operator," "Value," "Rule," 
"Public Flag," and "Description" are entered into the "State Transition" block) and 

15 the middle of the screen in Figure 3, which shows transitions, with each permitted 
transition having a "From State Name", a "To State Name", a "Public Flag", a "Rule 
Field Name" a "Rule Operator", and a "Rule". Typically, state machine and state 
model rules are expressed as "If present state is *0' and input is *0\ then new state is 
* 1 \ but if input is * 1 \ then new state is 4 0*; and if present state is * V and the input is 

20 4 0\ then the output is '0\ But if the input is ' 1* , then the output is *1\ 

As shown in the next block of Figure 1, entering these rules into the graphical user 
interface of Figure 3 causes the appropriate rules to be extracted from the database, 
block 67, and, in the next block, assembled into a state machine execution engine, 
25 block 69 of Figure 1 and implemented as in block 70 of Figure 2. This produces an 
enforced state model on targeted business objects, block 71, and the target business 
object is enabled, as shown in block 73. 

The State Model Class Definition reproduced in Appendix A and the State Machine 
30 Source Code is reproduced in Appendix B. 

Multi-method Sales Pipeline 
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The multi-method sales pipeline method and system of our invention is illustrated in 
Figure 4. Figure 4 shows a large funnel 1 and small funnels 11, 13, and 15 
representing deals being worked in different methodologies on a single sales pipeline 
graphic. The small funnels, 11, 13, and 15, represent the sales pipelines of a group of 
deals being worked in a single methodology. The bigger funnel 1 at the top represents 
a way to combine the small ones and compare the value of all of the deals to the sales 
person's quota. As shown in Figure 4, the funnel chart engine breaks deals up into 
classes, for example, qualifying deals, 3, working deals, 5, and closing deals, 7. 
Within each class are categories of deals, such as telesales process deals, 11, strategic 
deals, 13, and standard process deals, 15. 

A flow chart of this embodiment of the system and method of our invention is shown 
in Figure 5. As shown in Figure 5, an opportunity is created on one side, block 21, 
and a sales method is created on the other side, block 31, which method is broken 
down into sales cycles within the sales method, block 33, and further broken down 
into sales phases, block 35, for each of the sales cycles, block 33. The processed sales 
method and the opportunity are brought together, as shown in block 37, and the sales 
method associated with a sales opportunity. The sales opportunity is then advanced 
based upon the sales method, as shown in block 39. The sales opportunities are then 
sorted and grouped by sales methods, cycles, and phases, as shown in block 41. The 
data, grouped by sales method, sales cycle, and deal phase, is then passed to a 
charting engine, as shown in block 43, and from the charting engine to the Sales 
Pipeline Funnel Chart of Figure 4, as shown in block 45 of Figure 5. 

Sales Assistant 

The sales assistant module of the system and method of our invention monitors the 
state of the deal as it is being worked and suggests, but need not require, specific 
actions and evaluations ("assessments") that should be performed based on the 
methodology employed for that specific deal. Using the state model, as deals move 
from stage to stage, the sales assistant module continues to monitor the deals to 
determine (based on the then current methodology) whether additional actions or 
assessments should be suggested. A flow chart for the Sales Assistant is shown in 
Figure 6. 
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The Sales Assistant is a coaching tool. With the Sales Assistant, everyone in an 
organization can learn from each other, and especially from the most -experienced 
sales reps. Activity Templates automatically list, schedule, and assign all of the 
5 activities that are needed to move sales opportunities quickly from one -sales -stage to 
the next. Assessments compare like opportunities with a "model" or "optimal" 
opportunity. 

As shown in the flow chart of Figure 6, templates, such as a Sales Assistant Activity 
10 Template, block 51, and a Sales Assistant Assessment Template, block 53, are 
created. These two templates are then manually assigned to Opportunities, Accounts, 
and Contacts, in block 55. Meanwhile, the templates are also associated with sales 
methods and opportunities, as shown in block 57 on the right hand side of Figure 6, 
and then associated with opportunity sales methods, block 59, and the sales cycles 
15 advanced, block 61. Sales cycles are advanced using the permitted states and the 
permitted transitions of the state model described herein above. The activity templates 
and assessment templates are then assigned, block 63, and the assessments and 
activity plans performed, block 65. The product or output of the assessment and 
activities function, block 65, is the suggestion of additional actions and assessments, 
20 based upon permitted states and state transitions, and the comparison of the deal with 
optimal deals. 

Sales Assistant Module 

25 Sales Assistants Module Technical Description: 

Sales Assistants provide a unique method to facilitate and to monitor the life cycle of 
a sales opportunity, account or a contact. The components included in a C++ 
exemplification of this method are: 

30 

Activity Template Object - a business object that holds a set user definable actions 
that can be applied to an opportunity/Account/contact. 
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Assessment template object - a business object that holds a set of user definable 
assessment rules for evaluating the quality of an opportunity/account/contact. 

Sales Assistant Agent - a smart agent program that can assign Activity and 
Assessment to an opportunity/account/contact based on the sales methodology and 
cycles. 

It would, of course, be understood that the Sales Assistant methodology can be used 
for production planning and debottlenecking, among other industrial applications. 

The following Appendices are code listings for the methods described herein. 
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I. APPENDIX A - STATE MODEL DEFINITION SOURCE CODE 



/////////////////////////////////////////////////////////////////////////////// 
5 // 

// bcstatem.h State Model Business Component Class functions, types, and 

definitions 

// 

// Copyright (C) 1997, Siebel Systems, L.P., All rights reserved. 
10 // 

// FILE: bcstatem.h 

// $ Revision: 1 $ 

// $Date: 8/10/99 6:25p $ 

// $Author: Hastings $ of last update 
15 // 

// CREATOR: Michael T. Yu 

// 

/////////////////////////////////////////////////////////////////////////////// 

20 #ifndef BCSTATEM H 

#define BCSTATEM H 

/////////////////////////////////////////////////////////////////////////////// 
25 // 

// CSSBCStateModel - CSSBCStateModel Object Class Definition 
// 

/////////////////////////////////////////////////////////////////////////////// 
^ class SS_EXPORT_CIASS CSSBCStateModel : public CSSBusComp 

SS_DECIARE_DYNCREATE (CSSBCStateModel) 

// class member variable declarations 

35 private : 

// class member function declarations 
40 protected: 

CSSBCStateModel (void) ; 
virtual -CSSBCStateModel (void) ; 

45 virtual ErrCode SqlWriteRecord (void) ; 

public: 
protected: 



50 



55 



60 



70 



private : 

virtual ErrCode ValidateOverlappedActiveStateModel (void) ; 

>; 



/////////////////////////////////////////////////////////////////////////////// 
// 

// CSSBCStateModelState - CSSBCStateModelState Object Class Definition 
65 // 

/////////////////////////////////////////////////////////////////////////////// 
class SS_EXPORT_CIASS CSSBCStateModelState : public CSSBusComp 

SS_DECLARE_DYNCREATE (CSSBCStateModelState) 



// class member variable declarations 
private : 
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CSt ring m_typeValue ; 

// class member function declarations 
protected: 

CSSBCStateModelState (void) ; 
virtual -CSSBCStateModelState (void) ; 

public: 

virtual BOOL HasPickList (LPCSTR pFieldName); 

virtual ErrCode GetPicXList (LPCSTR pFieldName, CSSBusCorap*& pPickList) ; 
protected: 
private: 
); 

/////////////////////////////////////////////////////////////////////////////// 

// CSSBCStateTransition - CSSBCStateTransition Object Class Definition 

///////////////////////////////////////////////////////////////////// ////////// 
class SS_EXPORT_CLASS CSSBCStateTransition : public CSSBusComp 

SS_DECLARE_DYNCREATE (CSSBCStateTransition) 

// class member variable declarations 

private: 

// class member function declarations 
protected: 

CSSBCStateTransition (void) ; 
virtual -CSSBCStateTransition (void) ; 

public: 

virtual BOOL CanUpdate (LPCSTR pFieldName) ; 

protected: 

virtual ErrCode SqlSetFieldValue (LPCSTR pFieldName, 

LPCSTR pFieldData) ; 
virtual ErrCode SqlWriteRecord (void) ; 

private: 
}; 

#endif // BCSTATEM H , _ 



static char file_idt3 - «$Header: /v60/src/clients/common/bc/bcstatem.cpp i 
8/10/99 6:25p Hastings $ n ; " 

/////////////////////////////////////////////////////////////////////////////// 
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// 

// bcstatem.cpp : State Model Business Component Class implementation file 
// 

// Copyright (C) 1995 - 1998, Siebel Systems. I*. P., All rights reserved. 
// 

// FILE: bcstatem.cpp 

// $Revision: 1 $ 

// $Date: 8/10/99 6:25p $ 

// $Author: Hastings $ of last update 

// 

// CREATOR: Michael T. Yu 
// 

/////////////////////////////////////////////////////////////////////////////// 

#include "stdafx.h" 

#ifndef OBJMISC_H 

# include "objmisc.h" 
#endif 

tfifndef BUSCOMP_H 

# include "buscomp.h" 
#endif 

#ifndef BUSOBJ_H_ 

include "busobj.h" 
#endif 

#ifndef SQLOBJ_H 

# include "sqlobj .h" 
#endi£ 

Bifndef BCSTATEM H 

# include "bcstatem.h" 
#endif 



// Comparison operators 
#define SQL_ OP_IS_NULL "IS NULL" 

#define SQL_OP_I S_NOT_NULL "IS NOT NULL" 
fcdefine SQL_OP_Is2uPDATED "IS UPDATED" 



// extern variables 

// extern functions 

// global variables 

// static variables 

static BOOL bDebug = FALSE; 

// static functions 

// MACRO statements 

SS_IMPLEMENT_DYNCREATE (CSSBCStateModel , CSSBusComp) 
S S__ I M PIiEMENT_D YNCREAT E ( CSSBCS t at eModelSt ate , CSSBusComp ) 
SS_IMPLEMENTJ5YNCREATE ( CSSBCS tateTrans it ion, CSSBusComp) 

// debug declarations 
#ifdef _DEBUG 

#undef THIS_FILE 

static char BASED_CODE THIS_FILE [1 = FILE ; 

#def ine new DEBUG_NEW 
#endif 



/////////////////////////////////////////////////////////////////////////////// 

// CSSBCS t at eModel Business Component 
// 

/////////////////////////////////////////////////////////////////////////////// 

EXPORT CSSBCSt at eModel : : CSSBCS tat eModel (void) 
{ 
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EXPORT CSSBCStateModel : : -CSSBCStateModel (void) 
) 

// 

// CSSBCStateModel :: SglWriteRecord 
// 

// Purpose: 

// Before commit the change verify that there is no other overlapped 
// active state model defined for the same BusComp/ Field 

ErrCode CSSBCStateModel: : SqlWriteRecord (void) 
ErrCode err; 

DO (ValidateOverlappedActiveStateModel ()); 

DO (CSSBusCorap: : SqlWriteRecord () ) ; 

ll_abort : 

return (err) ; 

} 

// 

// CSSBCStateModel: : ValidateOverlappedActiveStateModel 
// Purpose : 

// Verify that there is no other overlapped active state model 
// defined for the same BusComp/ Fie Id 

ErrCode CSSBCStateModel : :ValidateOverlappedActiveStateModel (void) 

ErrCode err; 

CSt r ingArray errParmArray ; 

CSSObjectBase* pErrChild = NULL; 

CSSBCStateModel* pBCStateModel » NULL; 

CSSSqlBCDef* pSqlBCDef . NULL; 

CSSRecord* pRecord = NUIoL; 

CSt ring fieldData; 

CString Name; 

CString searchSpec; 

CSSDateTime dateTimel ; 

CSSDateTime dateTime2; 

// create state model buscomp 

DOCHILD (mjModel, GetSqlBCDef (m_busCompName, pSqlBCDef ) ) ; 

m_pModel->ConstructBusComp (pSqlBCDef, m_pBusOb j . ( CSSBusCorap* &) pBCStateModel) 
DO (GetErrorCode ( ) ) ; 

if (! pBCStateModel) 
{ 

err « SSAOMErrConstrBusComp; 
^ goto ll_abort; 

FindWorkSet (m_activeRow, pRecord) ; 
// 

/ / Construct the search spec for m pBCStateModel 

// The purpose of constructing this search spec is to ensure that 
// at any given period of time there can be only one active 
// state model against a business object field 

DOCHILD (mjpSqlObj, FieldValue (pRecord, "Id", Name) ) ; 
AddQuotes (Name, •"•); 
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searchSpec = ° ( [Id] <> n + Name + ") AND ■ ; 

DOCHILD (m_pSqlObj, FieldValue (pRecord, " BusComp Name " , Name)); 
AddQuotes (Name, 1 " • ) ; 

searchSpec » ( [BusComp Name] » " + Name + n ) AND 

DOCHILD (m_pSqlObj, FieldValue (pRecord, "Field Name", Name) ) ; 
AddQuotes (Name, • • • ) ; 

searchSpec "( (Field Name] ■ ■ + Name ♦ ") AND B ; 

DOCHILD (m_pSqlObj. FieldValue (pRecord, "Activation Date/Time" , dateTimel )) ; 
DOCHILD (m_pSqlObj, FieldValue (pRecord, "Expiration Date /Time" , da teTime2) ) ,- 

dateTimel . GetAsString ( f ieldData) ; 
AddQuotes (f ieldData, •"•); 
searchSpec +«"("; 
searchSpec ♦■'■{■; 

searchSpec "([Activation Date/Time] <« n ♦ f ieldData + ") AND »; 

searchSpec +="("; 

searchSpec "([Expiration Date/Time) >« " + f ieldData + ") OR 

searchSpec +» "([Expiration Date/Time] IS NULL)"; 

searchSpec +»")"; 
searchSpec +«* " ) OR " ; 

if ( !dateTime2 . IsNull ( ) ) 
searchSpec ♦= " ( " ; 

searchSpec "([Activation Date/Time] >- " + f ieldData + ")"; 

if (!dateTime2.IsNull <)) 
{ 

dateTime2. GetAsString (f ieldData) ,- 
AddQuotes (f ieldData, ■ " • ) ; 
searchSpec " AND "; 

searchSpec ♦» "([Activation Date/Time] <o « + f ieldData + ")"; 

searchSpec ♦=")"; 

} 

searchSpec ♦■■)■;' 

DOCHILD (pBCStateModel, SetNamedSearch ("State Model", searchSpec)); 
DOCHILD (pBCStateModel, Execute (FALSE, FALSE, TRUE)); 
DOCHILD (pBCStateModel, Home () ) ; 
f ieldData. Empty () ; 

for (err » pBCStateModel ->CheckActiveRow (); err »* OK; 
err = pBCStateModel ->Next Record ()) 

{ 

// Concatenate the overlapping state modle names 

DOCHILD (pBCStateModel, FieldValue ("Name", Name)); 
if (f ieldData. I sEmpty () ) 

f ieldData = "\t*" ♦ Name + "•«; 
else 

f ieldData ♦« "\n\t'" + Name + "•«; 

) 

if (err « SSAOMErrActiveRow) 
{ 

//No Active Row: means no overlap, return OK 
err - OK; 

) 

else if (err =« SSASqlErrEOF) 

err = I DS_ERR__OVERLA P P ED_ ACT I VE_S TATE_MODEL ; 
errPannArray.Add (f ieldData) ; 

} 

ll_abort : 

SetErrorMsg (err, errParmArray , pErrChild) ; 
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if (pBCStateModel) 
{ 

// do not call Release <) , it will break the connection of 
// the BusObj and the original BusComp and cause memory leak 

pBCStateModel ->m_pBusObj - NULL; 

delete pBCStateModel ; 

return (err) ; 



///////////////////// ///// ////// / // //////////////////////////////////////////// 
// CSSBCStateModelState Business Component 

tttttttiitiiittittiiiiitiiiitiuiiiitititiiittiiiiiiitiiiimtiimittmntui 

EXPORT CSSBCStateModelState:: CSSBCStateModelState (void) 
} 

EXPORT CSSBCStateModelState: : -CSSBCStateModelState {void) 



// CSSBCStateModelState: :HasPickList 
// Purpose: 

// Dynamically disable the PickList for 'State' field if 
// the state model field do not have a LOV PickList 

BOOL EXPORT CSSBCStateModelState : :HasPickList (LPCSTR pFieldName) 

^ if (lstrcrapi (pFieldName, -State Name") «= 0) 

CString busCompName; 

CString fieldName; 

CSSPickListDef* pPickListDef « NULL; 

CSSSqlBCDef* pSqlBCDef - NULL; 

CSSSqlPieldDef* pSqlPieldDef = NULL; 

if ( ! m_pParent BusComp) 
return (FALSE) ; 

// Is parent BusComp "State Model" 

if ( m_pParent BusComp - >m_busCompName !» "State Model") 
return (FALSE) ; 

// Get the BusComp name defined for the state model 

lf re^rn r ^FALSE?^" >FieldValUe ( " BusComp NameB » busCompName) != OK) 
// BusComp name cannot be empty 

if (busCompName . I sEmpty ( ) ) 
return (FALSE) ; 

// Get the Field name defined for the state model 

if (m_pParentBusComp->FieldValue ("Field Name", fieldName) !« OK) 
return (FALSE); ' 

// Field name cannot be empty 

if (fieldName. IsEraptyO ) 
return (FALSE) ; 
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20 



25 



30 



35 



// Get: BusComp definition 

if <m_pModel->GetSqlBCDef (busCompName, pSqlBCDef) != OK) 
return (FALSE); 

if (IpSqlBCDef) 
return (FALSE) ; 



10 // Get Field definition 



if <lpSqlBCDef->GetSqlFieldDe£ (fieldName, pSqlFieldDef ) ) 
return (FALSE) ; 



15 if ( IpSqXFieldDef ) 

return (FALSE) ; 



if (pSqlFieldDef->m_pickListName.IsEmpty ()) 
return (FALSE) ; 

// Get PickList definition 

if ( !m_pModel->GetPickListDef ( pSq 1 Fie ldDef ->m_pickList Name, pPickListDef)) 
return (FALSE) ; 

if (! pPickListDef) 
return (FALSE) ; 

// Get PickList type value 

if (pPickListDef ->m_type Value . I sEmpty ()) 
return (FALSE) ; 

// Get PickList* s BusComp definition 

if (injpModel->GetSqlBCDef (pPickListDef - >m_busCompName , pSqlBCDef ) ) 
return (FALSE) ; 



if (! pSqlBCDef) 
40 return (FALSE) ; 

// Is table name «S_LST_OF_VAL« 

if (pSqlBCDef ->m_tableName !« " S_LST_OF_VAL M ) 
45 return (FALSE); 

m_type Value « pPickListDef ->ra_type Value; 

) 

50 return (CSSBusComp: :HasPickList (pFieldName) ) ; 



55 // CSSBCStateModelState: :GetPickList 
// 

// Purpose: 

// Override CSSBusComp: : Get PickList in order to modify the 
// search spec for state field 
60 // 

ErrCode CSSBCStateModelState :: Get PickList (LPCSTR pFieldName, 

CSSBusComp* & pPickList ) 

65 ErrCode err » OK; 

DO (CSSBusComp: : Get PickList (pFieldName, pPickList) ) ; 
if (Istrcmpi (pFieldName, "State Name") o) 

70 { 

CSt ring searchSpec; 

if ( !m_typeValue.IsEmpty {)) 

searchSpec = "(Type) « \"" + m type Value + "\*"; 
75 else 

searchSpec « "(Id) = \"Junk Row Id\"°; 
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^ pPickList->SetNamedSearch ("State Name Pick List" ,' searchSpec) ; 

ll_abort : 

SetErrorMsg (err, NULL, NULL) ; 
return (err) ; 

} 

'niilltiitttiilHiltlttlltliltltliitltltilllilltlllltttlltltNUIitilittUIIIH 

// CSSBCStateTransition Business Component 
// 

//////////////////////////////////////////////////////////////////// /////////// 
EXPORT CSSBCStateTransition: : CSSBCStateTransition (void) 

} 

EXPORT CSSBCStateTransition: : -CSSBCStateTransition (void) 
} 

// 

// CSSBCStateTransition: :CanUpdate 
// 

// Purpose: 

// If the "Rule Field Name" is empty do not let the user 
// edit the "Rule Operator" field 

// If the "Rule Operator" is empty, 'IS NULL ' , 'IS NOT NULL' or 
// 'IS UPDATED' do not let the user edit the "Rule Value" field 

BOOL CSSBCStateTransition: :CanUpdate (LPCSTR pFieldName) 
if (CString ("Rule Operator") »- pFieldName) 

// If the "Rule Field Name" is empty do not let the user 
// edit the "Rule Operator" field 

CString f ieldData,- 

if (FieldValue ("Rule Field Name" , f ieldData) ok && 
^ f ieldData. IsErapty ()) 

^ return (FALSE) ; 

else if (CString ("Rule Value") =» pFieldName) 

// If the "Rule Operator" is empty, 'IS NULL' , 'IS NOT NULL' , or 
// -IS UPDATED' do not let the user edit the "Rule Value" field 

CString f ieldData; 

if ((FieldValue ("Rule Operator", f ieldData) « OK) && 
( f ieldData. I sEmpty () | | 
f ieldData «« SQL_OP_I S__NULL | | 
f ieldData -« SQL_OP_IS_NOT_NULL | | 
f ieldData «« SQL__OP_IS_UPDATED) ) 

^ return (FALSE) ; 
return (CSSBusComp: :CanUpdate (pFieldName) ) ; 



// 
// 

// CSSBCStateTransition: : Sgl Set FieldValue 
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// Purpose: 

// If the "Rule Field Name" field is set to empty 

// then clear the "Rule Value" field 

// If the "Rule Operator" field is set to empty, 

//. 'IS NULL', 'IS NOT NULL', or * IS UPDATED ' then 

// clear the "Rule Value" field 

// 

ErrCode CSSBCStateTransition: : SqlSetFieldValue (LPCSTR pFieldName, 

LPCSTR pFieldData) 

ErrCode err; 

DO (CSSBusComp: : SqlSetFieldValue (pFieldName, pFieldData) ) ,- 

if (CString ("Rule Field Name") « pFieldName) 
{ 

// If the "Rule Field Name" field is set to empty 
// then clear the "Rule Value" field 

CString fieldData = pFieldData; 

if (fieldData. I sEmpty ()) 
{ 

CSSBusComp: : Set FieldValue ("Rule Operator", "") ; 
CSSBusComp: : Set FieldValue ("Rule Value". »"); 

> 1 

else if (CString ("Rule Operator") mm pFieldName) 

// If the "Rule Operator" field is set to empty, 
// • IS NULL", 'IS NOT NULL' , or 'IS UPDATED ' then 
// clear the "Rule Value" field 

CString fieldData - pFieldData; 

if (fieldData. I sEmpty () | | 

fieldData «« SQL_OP_IS_NULL | | 

fieldData SQL_OP_IS_NOT_NULL | | 

fieldData «=« SQL OP IS UPDATED) 
{ ~ 

CSSBusComp: : Set FieldValue ("Rule Value", »"); 

} 

} 

ll_abort : 

return (err) ; 

} 



// 
// 

// CSSBCStateTransition: : Sql Writ eRe cord 
// 

// Purpose: 

// If the "Rule Field Name" field is not empty then the 

// "Rule Operator" field can not be empty 

// If the "Rule Operator" field is not empty, 'IS NULL*, 

// 'IS NOT NULL 1 , and 'IS UPDATED' then the "Rule Value" 

// f ield can not be empty 

// 

ErrCode CSSBCStateTransition: : SqlWriteRecord (void) 

ErrCode err = OK; 

CString errParm; 

CString fieldData; 

CSSField* pField - NULL; 

CSSRecord* pCurRecord « NULL; 

FindWorkSet (m_activeRow, pCurRecord) ; 

DO (Sql FieldValue (pCurRecord, "Rule Field Name", fieldData)), 

// If the "Rule Field Name" field is not empty then the 
// "Rule Operator" field can not be empty 
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if (!f ieldData. IsEmpty ()) 

if (GetFieldDef ("Rule Operator", pField) ) 

DO (SglPieldValue (pCurRecord, "Rule Operator" , f ieldData) ) 

if (f ieldData. IsEinpty {)) 

err « SSASqlErrReqField; 

errParm = pField- >GetErrorName (); 

goto ll_abort; 



) 

DO (SqlFieldValue (pCurRecord, "Rule Operator" , f ieldData) ) ; 

//If the "Rule Operator" field is not empty, 1 IS NULL' 
// 'IS NOT NULL', and 1 IS UPDATED 1 then the "Rule Value" 
// field can not be empty 

if ( ! f ieldData . IsEmpty () && 

f ieldData ! = SQL_OP_IS_NULL && 

f ieldData !« SQLJDP^I S_NOT_NULL && 

f ieldData ! = SQL_OP_IS_UPDATED) 

if (GetFieldDef ("Rule Value", pField) ) 

DO (SqlFieldValue (pCurRecord, "Rule Value", f ieldData) ) ; 

if (f ieldData. IsEmpty ()) • 

err « SSASqlErrReqField; 

errParm « pField- >GetErrorNarae () ; 

goto ll_abort; 

} 

} 

DO (CSSBusComp: : SqlWriteRecord {)); 

ll_abort : 

SetErrorMsg (err, errParm, NULL); 
return (err) ; 
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II. APPENDIX B - STATE MACHINE SOURCE CODE 



/////////////////////////////////////////////////////////////////////////////// 
5 // 

// CSSBCBaee - CSSBCBase Object Class Definition 
// 

/////////////////////////////////////////////////////////////////////////////// 

10 class SS_EXPORT_COMMONBCCLASS CSSBCBase : public CSSBusComp 
{ 

SS DECLARE DYNCREATE (CSSBCBase) 



15 



50 



// Other Functionality 



20 // State Model 

BOOL mJbStateModel ; 

CSSQuery* ra_pRuleExpr ; 

CSSBusObj* m_pBOStateModel ; 

25 CSSBusComp* m_pBCStateModel ; 

CSSBusComp* m_pBCTransition; 

CMapStringToOb m_mapStateModel ; 

class StateModel 
30 { 

public: 

StateModel (void) 

35 m bLOVPickList - FALSE; 

» " 

CSt ring m_rowId ; 

BOOL mJbLOVPickList ; 

40 CString m_LOVTypeValue ; 

CMapStringToPtr m mapStateRestriction; 

); 

enum SMDeleteUpdate 

45 { 

SMDeleteOr Update , 

SMDelete. 

SMUpdate 

}; 



// Private class for State Model read-only record feature. 



class StateRestriction 

« { 

DD public: 

StateRestriction (void) 
{ 

mJbRestrictDelete = FALSE; 

60 m^bRestrictTransition = FALSE; 

m_bRestrictUpdate = FALSE; 

) 

BOOL m__bRes trict Delete; 
65 BOOL mJbRest r ict Trans it ion; 

BOOL m bRestrictUpdate; 

}; 



70 



// Other Functionality 
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public : 

virtual BOOL 

virtual BOOL 

virtual ErrCode 

protected: 

virtual 
virtual BOOL 
virtual ErrCode 



CanDelete 
CanUpdate 
GetPickList 



CSSBCBase (void) ; 
-CSSBCBase (void) ; 



(void) ; 

(LPCSTR pPieldName) ; 

(LPCSTR pFieldName , 

CSSBusComp*& pPickList) ; 



IsChildUpdateDisabled (LPCSTR pChildName) ; 



SqlCreate 



(CSSSqlBCDef* 
CSSBusOb j * 
WORD 

CSSSglOb j * 



pSqlBCDef , 
pBusOb j , 
busCompType, 
pSqlObj) j 



virtual ErrCode SqlSetPieldValue 



(LPCSTR pFieldName, 
LPCSTR pFieldData) ; 



// State Model 
private : 
ErrCode 

BOOL 

ErrCode 

ErrCode 



void 
BOOL 

SMDeleteOrUpdate , 



Cons tructSt at eModelPickList Sear chSpec 

( LPCSTR pFieldName , 

CSSBusComp* pPickList) ; 



EvalBoolExpr 

LoadStateModel 

VerifyStateModel 



(CString strExpr) ; 
(void) ; 

(LPCSTR pFieldName, 
LPCSTR pFieldData) ; 



BOOL 



UnLoadStateModel (void) ; 

CanSMDeleteUpdate (SMDeleteUpdate type 

LPCSTR pFieldName « NULL) ; 

IsRestrictTransition (LPCSTR pFieldName, 

CString strFieldData) ; 



CSSBCBase : : CSSBCBase (void) 



{ 



// Other Functionality 



// State Model 

m_bStateModel s FALSE; 

m_pBOStateModel = NULL; ' 

m_pBCStateModel * NULL; 

m_pBCTransition s mttt.t.; 

m_pRuleExpr - NULL; 



CSSBCBase :: -CSSBCBase (void) 
// Other Functionality 
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// State Model 
UnLoadStateModel ( ) ; 
// 

// Field-level user properties 
// 

// Other Functionality 



// 

// CSSBCBase: : CanDelete 
// 

// Purpose: 
// 

// Override CSSBusComp: :CanDelete in order to check if the record can be deleted 

// in the row's current state. 

// 

BOOL CSSBCBase :: CanDelete (void) 
{ 

if ( fCanSMDeleteUpdate <SMDelete) ) 
return (FALSE) ; 

// Other Functionality 



return (CSSBusComp: : CanDelete () ) ; 

) 



BOOL CSSBCBase :: CanUpdate (LPCSTR pFieldName) 
// Other Functionality 



if ( ICanSMDeleteUpdate (SMUpdate, pFieldName)) 
return (FALSE) ; . 

// Other Functionality 



) 



return (CSSBusComp: :CanUpdate (pFieldName) ) ; 



// 
// 

// CSSBCBase: : Get PickList 
// 

// Purpose: 
// 

// Override CSSBusComp :: Get PickList in order to modify the 

// search spec for state model field 

// 

ErrCode CSSBCBase: : Get PickList (LPCSTR pFieldName, 

CSSBusComp* 6 pPickList) 

ErrCode err = OK; 
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DO (CSSBusComp: :GetPickList (pFieldName, pPickList)); 
// 

// Call ConstructStateModelPickListSearchSpec () to add the additional 
// search spec for this PickList if state Model is defined 



DO ( Const ructStateModelPickListSearchSpec (pFieldName. pPickList)); 



ll_abort : 

SetErrorMsg (err, NULL, NULL) ; 
return (err) ; 

} 



BOOL CSSBCBase: : IsChildUpdateDisabled (LPCSTR pChildName) 



// Other Functionality 



if OCanSMDeleteUpdate ()) 
return (TRUE) ; 



^ return (CSSBusComp; : IsChildUpdateDisabled (pChildName)); 

ErrCode CSSBCBase: :SqlCreate (CSSSqlBCDef * pSqlBCDef, 

CSSBusOb j * pBusObj , 
WORD busCompType , 

CSSSqlOb j * pSglOb j ) 

//Other Functionality 



// ..... 

// BASESM.CPP 



// 

// Load State Model 
// 

DO (LoadStateModel ()); 
// Other Functionality 



ErrCode CSSBCBase SglSetFieldValue (LPCSTR pFieldName, 
j LPCSTR pFieldData) 

// Other Functionality 



// 

// Check if state transition is allowed 

DO (VerifyStateModel (pFieldName, pFieldData)); 
// Other Functionality 
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static char file_id[] e "$Header : /v60/src/clients/common/bc/basesm.cpp 2 9/10/99 
18:22 Myu $°; 

/////////////////////////////////////////////////////////////////////////////// 
// 

// Copyright (C) 1995 - 1998, Siebel Systems, L.P., All rights reserved. 
// 

// FILE: basesm.cpp 

// $Revision: 2 $ 

// $Date: 9/10/99 18:22 $ 

// $Author: Myu $ of last update 

// 

// CREATOR: Michael T. Yu 

// 

// DESCRIPTION 

// Base Business Component Class for State Model implementation file 

// . 

/////////////////////////////////////////////////////////////////////////////// 

#include "stdafx.h" 

tfifndef BCBASE_H 

# include "bcbase.h" 
ftendif 

ftifndef _INC_STDLIB 

^include <stdlib.h> 
#endif 

ftifndef _INC_STRING 

# include 11 string, h" 
#endif 

ftifndef BUS0BJ_H_ 

# include "busobj .h n 
#endif 

ftifndef OBJMISC H 

ft include "objmisc.n" 
ftendif 

// extern variables 

// extern functions 

// global variables 

// static variables 

static BOOL bDebug « FALSE; 

// MACRO statements 

// debug declarations 
tfifdef _DEBUG 

ftundef THIS_FILE 

static char BASED_CODE THIS_FILE[) a FILE ; 

ftdefine new DEBUG_NEW 
ftendif 



// 

// CSSBCBase: :LoadStateModel 
// 

// Purpose: 
// 

// Load the active state models belong to current BusCorop 
// 

ErrCode CSSBCBase :: LoadStateModel (void) 
{ 

ErrCode err ■ OK; 

CSSObject* pErrChild » NULL; 

CSt ring value; 
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CString searchSpec; 

CString f ieldDatal ,- 

CString fieldData2; 

CSSDateTime dateTime; 

CSSBool bFlag; 

CSSBusComp* pMvgBCSMState «. NULL ; 

StateModel* pSM = NULL; 

StateRestriction* pSR a NULL; 

CSSPickListDef* pPickListDef = NULL; 

CSSSqlBCDef * pSqlBCDef * NULL; 

CSSSqlFieldDef * pSqlFieldDef = NULL; 

CSSBCState state; 

// 

// If user property "State Model" is not defined return OK 

if (!GetUserProperty ( (LPCSTR) "State Model", value)) 
return (OK) ; 

// 

// If user property "State Model" is not equal to "Y" return OK 

if (value ! = "Y") 
return (OK) ; 

// 

// Get "State Model" BusObj 

// and "State Model" and "State Model - Transition" BusCoraps 

// If State Model is not ready return OK 

// 

if (m_pModel->GetBusObj ("State Model ^ Engine", 

m_pBOStateModel) ! = OK) 

return (OK) ,- 

if (m^pBOStateModel - >GetBusComp ("State Model", 

mjpBCStateModel) != OK) 

return (OK) ; 

if (mjpBOStateModel->GetBusComp ("StateModel - Transition", 

m_pBCTransition) != OK) 

return (OK)-; 

// 

// Temporarily store the BusComp Name to f ieldDatal 

// and add quotes to the begining and end of f ieldDatal 

f ieldDatal = ra_busCompName ; 
AddQuotes (f ieldDatal ,•"'); 

// 

// Get current time and add quotes to the begining and end of fieldData2 

dateTime . SetToNow ( ) ; 

dateTime. GetAsString (fieldData2) ; 

AddQuotes ( f ieldData2 , • » ■ ) ; 

// 

// Construct the search spec for mjpBCStateModel 

searchSpec 

= » ( [BusComp Name) = " + f ieldDatal 

+ ") AND ((Activation Date/Time] <= " + fieldData2 

♦ ") AND (([Expiration Date/TimeJ IS NULL) OR ([Expiration Date/Time] >= « 
+ fieldData2 + "))"; 

DOCHILD (mjpBCStateModel, SetNamedSearch ("State Model", searchSpec)); 
DOCHILD (mjpBCStateModel, Execute (FALSE, FALSE, TRUE)); 
DOCHILD (mjpBCStateModel, Home ()) ; 
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for (err «=> m__pBCStateModel->CheckActiveRow {); err == OK; 
err = m_pBCStateModel- >Next Record ()) 

// Store field name and row id into the m__mapStateModel 

pSM e new stateModel; 

DOCHILD <ra_pBCStateModel, PieldValue ("Field Name 0 , f ieldDatal) ) ; 
DOCHILD <ra_pBCStateModel. GetldValue (pSM->m_rowId) ) ; 

// 

// Get the State field* a PickList definition 

//If the PickList is a LOV PickList set 

// pSM- >m_bLOVPickList to TRUE and 

// pSM->m_LOVType Value to the appropriate value. 

// 

if (m_jpSqlBCDef->GetSqlFieldDef (f ieldDatal, pSqlFieldDef ) ) 



{ 



} 



if ( ! pSqlFieldDef - >m_pickListName . ZsEmpty ( ) ) 

m_pModel->GetPickListDef (pSqlFieldDef ->ra_pickLi st Name, 

pPickListDef ) ; 

if (pPickListDef && ! pPickListDef - >m__type Value . IsEmpty <)) 

DOCHILD (m_pModel, GetSqlBCDef {pPickListDef ->m_busCompName, 

pSqlBCDef ) ) ; 

if (pSqlBCDef && pSqlBCDef ->m_tableName «= " S_LST_OF_VAL n ) 
pSM->m__bLOVPickList - TRUE; 

pSM->ra_LOVType Value - pPickListDef ->m_type Value; 

} 1 



pMvgBCSMState) ) 



// Load state restriction information 

DOCHILD (mjpBCStateModel , GetMvgBusComp ("State Name" 

// Save the state of "State Model - State" BusComp 

state. SaveBCState (pMvgBCSMState, "") ; 

DOCHILD (pMvgBCSMState, Execute ()); 
DOCHILD (pMvgBCSMState, Home ()); 

for (; err »- OK; err = pMvgBCSMState- >Next Record ()) 
{ 

pSR « new StateRestriction ( ) ; 

DOCHILD (mjpBCStateModel. FieldValue ("State Name" , value)); 
DOCHILD (m_pBCStateModel , 

FieldValue ("State Restrict Delete Flag" , bFlag)); 
pSR->m_bRestrictDelete - bFlag; 

DOCHILD (m_pBCStateModel, 

FieldValue ("State Restrict Transition Flag" , bFlag) ) ; 
pSR->m_bRestrictTransition = bFlag; 
DOCHILD (mjpBCStateModel , 

FieldValue ("State Restrict Update Flag" , bFlag)); 
pSR->m_bRestrictUpdate = bFlag; 

pSM->m_mapStateRestriction.SetAt (value, pSR) ; 

m_raapStateModel.SetAt (f ieldDatal, (CObject*) pSM) ; 
// Restore the state of "State Model - State" BusComp 
state. RestoreBCState (pMvgBCSMState) ; 

if ( (err ««= SSAOMErrActiveRow) | | (err = SSASqlErrEOF) ) 

err « OK; 
else 
{ 



pErrChild = pMvgBCSMState; 
goto ll_abort; 
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if (err SSAOMErrActiveRow) 
{ 

// No Active Row: means no active state model defined for current BusComp 
err = OK; 

} 

else if (err «=« SSASqlErrEOF) 

m_bStateModel = TRUE; 
m_pRuleExpr = new CSSQuery,- 
m_pRuleExpr- >m _pSqlObj = mjpSqlOb j ; 
err = OK; 

} 

ll_abort : 

SetErrorMsg (err, NULL, pErrChild) ; 

if ( !m_bStateModel) 

UnLoadStateModel () ; 

return (err) ; 

} 

void CSSBCBase: : UnLoadStateModel (void) 

if (m_pBOStateModel) 

ra_jpBOStateModel->Release (); 
m_pBOStateModel *= NULL; 
m_j?BCStateModel « NULL; 
mjpBCTransition = NULL; 

if (m_pRuleExpr) 

delete ra_pRuleExpr ; 

ra_pRuleExpr -= NULL; 

if (m mapStateModel.GetCount () > 0) 
{ " 

POSITION posSM; 
POSITION posSR; 
CString key; 
StateModel* pSM = NULL; 

StateRestriction* pSR = NULL; 

for (posSM ~ m_mapStateModel.GetStartPosition () ; posSM; ) 

injnapStateModel.GetNextAssoc (posSM, key, (CObject*&) pSM) ; 

for (posSR * pSM->m_raapStateRestriction.GetStartPosition () ; posSR; ) 

pSM->m_mapStateRestriction.GetNextAssoc (posSR, key, (void*&) pSR) ; 
delete pSR; 

} 

delete pSM; 



// 
// 

// CSSBCBase : : ConstructStateModelPickListSearchSpec 

// Purpose: 
// 

// modify the PickList search spec for state model field 

ErrCode CSSBCBase: :ConstructStateModelPickListSearchSpec (LPCSTR pPieldName, 
j CSSBusComp* pPickList) 

ErrCode err « OK; 
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CSSObject* pErrChild = NULL; 

StateModel* pSM e NULL; 

if ( SmJbStateModel) 
return (OK) ; 

if (IsInQueryState (}) 
{ 

DOCHILD (pPickList, SetNamedSearch ("State Pick List", "")); 
return (OK) ; 

} 

// 

// Locate the field name in the State Model Map 
// 

m_mapS t at e Model .Lookup (pFieldName, (CObject*&) pSM) ; 
// 

// If no state model is defined for this field, 

// do not set the additional search spec 

// 

if (!pSM || pSM->m_rowId.IsEmpty ()) 
return (OK) ; 

// 

// Locate the state model 

// 

if (m_pBCStateModel->PositionById (pSM->m_rowId) -» OK) 

BOOL bShowDefaultState ° FALSE; 

CString fieldData; 

CString stateFieldData; 

CString searchSpec; 

CSSRecord* pRecord « NULL; 

// 

// Get the original field value (From State Name) 
// 

GetActiveRecord (pRecord) ; 

DO (m_pSqlOb j - >FieldValue (pRecord, pFieldName, stateFieldData)); 

if (stateFieldData. IsBmpty ()) 
bShowDefaultState » TRUE; 

if (! bShowDefaultState) 
{ 

// 

// Check the "State Restrict Transition Flag" for this field 
// 

if ( ! IsRestrictTransition (pFieldName, StateFieldData)) 

DOCHILD (pPickList, SetNamedSearch ("State Pick List", "")); 
return (OK) ; 

) 

// 

// Construct the search spec for m pBCTransition 
// 

fieldData = pSM->m_rowId; 
AddQuotes (fieldData, • " • ) ; 

// ({State Model Id] « fieldData 

searchSpec « " ( [State Model Id] » ■ . + fieldData; 

if (pSM->m_bLOVPickList) 
{ 

// 

// Convert LOV Val to Name 
// 
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DOCHILD (m_pModel, 

^ GetLovValName (stateFieldData, pSM->m_LOVTypeValue, f ieldData) ) ; 

else 

f ieldData «= stateFieldData; 
AddQuotes (f ieldData, » ■ ' ) ; 
// ) AND ([From State Name} * f ieldData 

searchSpec ") AND ({From State Name] » ■ + f ieldData; 

f ieldData » GetPositionld (); 
AddQuotes (f ieldData, • » » ) ; 

// ) AND (([Public Flag] = «Y») OR (EXISTS ([Position Id] = f ieldData) ) ) 
searchSpec ") AND (([Public Flag) « \"Y\»)" ; 

searchSpec +- » OR (EXISTS ((Position Id] = - + f ieldData +«)))«; 
// 

// Set Named Search 
// 

DOCHILD (m_pBCTransition, 

SetNamedSearch ("state Transition", searchSpec)); 

DOCHILD (m_pBCTransition, Execute (FALSE, FALSE, TRUE) ) ; 

DOCHILD (m_pBCTransition, Home ()); 



if (bShowDefaultState || m_pBCTransition->CheckActiveRow () -= OK) 

int index; 

BOOL bFirst; 

CString pickListSearchField; 

CString stateName; 

CSSPickMapDef* pPickMapDef; 

// 

// Get the PickList field name used in the pick map 



for (bFirst * TRUE; 

pPickList->EnumPickMapDefs (bFirst, pPickMapDef, index); 
bFirst a FALSE) 

{ 

if (pFieldName « pPickMapDef ~>m_fi el dName) 

pickListSearchField = pPickMapDef ->m_pickFieldName - 
break; 

} 

} 

searchSpec . Empty ( ) ; 

if (bShowDefaultState) 

DOCHILD (m_pBCStateModel, FieldValue ("StateName", stateName))- 

if (pSM->m bLOVPickList) 

{ 

// 

// Convert LOV Name to Val 
// 

DOCHILD (m_pModel, 

GetLovNameVal (stateName, pSM- >m_LOVTypeValue , f ieldData) ) ; 

else 

f ieldData *= stateName; 
AddQuotes (f ieldData, •"•); 

searchSpec » [« + pickListSearchField +")="+ f ieldData; 
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else 

{ 

for (; err »» OK; err = m_pBCTransition- >NextRecord {)) 
{ 

if (m_pBCTransition->FieldValue ("To State Name", 

BtateNarae) «« OK) 

{ 

if ( ! searchSpec . isEmpty ( ) ) 
searchSpec +« n OR ■ ; 

if (pSM->m bLOVPickList) 
{ 

// 

// Convert LOV Name to Val 
// 



f ieldData) ) ; 



} 



DO CHILD (ra_pModel. 

GetLovNameVal (stateName, pSM->m_LOVType Value. 

) 

else 

f ieldData « stateNarae; 
AddQuotes (f ieldData, • • • ) ; 

searchSpec ♦= " [" + pickListSearchField ♦ "} = " + f ieldData; 



} 



> 

if (err == SSASqlErrEOF) 
err = OK; 

) 

pPickList->SetNamedSearch ("State Pick List", searchSpec); 

} 

else 
{ 

// 

// Force the PickList bring up nothing 
// 

pPickList->SetNamedSearch ("State Pick List", "[Id] « \"Junk Row Id\"") ; 

} 



ll_abort : 

SetErrorMsg (err, NULL, pErr Child) ; 
return (err) ; 

.} 
// 

// CSSBCBase: : Verif yStateModel 
// 

// Purpose: 
// 

// Validate the state transition 
// 

ErrCode CSSBCBase :: Verif yStateModel (LPCSTR pFieldName, 

LPCSTR pFieldData) 

{ 

ErrCode err = OK; 

CStringArray er rParmArray ; 

CSSObject* pErrChild « NULL; 

StateModel* pSM « NULL; 

// 

// If undo is in progress skip the validation 
// 

if (I sUndoRedo I nProgr e s s ( ) ) 
return (OK) ; 

// 

// If no state model is defined for this BusComp skip the validation 
// 
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if ( lra_bStateModel) 
return (OK) ; 

// 

// Locate the field name in the State Model Map 

m_mapStateModel . Lookup (pFieldName, (CObject*&) pSM) ; 

//If no state model is defined for this field skip the validation 

if <!pSM || pSM->m_rowId.IsEmpty ()) 
return (OK) ; 

// 

// Locate the state model 
// 

if (m_pBCStateModel->PositionById (pSM->m_rowId) « OK) 

CString searchSpec; 

CSt ring searchSpecRT; 

CString oldFieldData ; 

CString newFieldData = pFieldData; 

CString f ieldData ; 

CString ruleExpr; 

CString stateName; 

CSSRecord* pRecord = NULL; 

// 

// Get the original field value (From State Name) 
GetActiveRecord (pRecord) ; 

DO (m_pSqlQbj->FieldValue (pRecord, pFieldName, oldFieldData)); 
if (oldFieldData. IsEmpty ()) 
// 

// If original field value is »« then the default state model state 

// is the only valid next state. 

// 

DO CHILD (m_pBCStateModel, FieldValue ("StateName", stateName))- 
if (pSM->m_bLOVPickList) 

// 

// Convert LOV Name to Val 
// 

DOCHILD (m_pModel, 

GetLovNameVal (stateName, pSM->m_LOVType Value, f ieldData) ) ; 

else 

f ieldData - stateName; 

// 

//If we enter the default state return OK 

if (newFieldData » f ieldData) 
^ return (OK) ; 

else 
{ 

#if 0 // Fixed bugs: 12-LNCGD and 12-LNCGF 
// 

// Check the "State Restrict Transition Flag- for this field 

if ( HsRestrictTransition (pFieldName, oldFieldData)) 
return (OK) ; 

#endif 

} 



36 



WO 00/33235 



PCT/US99/283S7 



// 

// Construct the search spec for m_pBCTransition: 

// verify the from and to states and the authorization 

// 

fieldData = pSM- >m_rowid ; 
AddQuotes (fieldData, • "•); 

// ( (State Model Id] - fieldData 

searchSpec » "([State Model Id) «* " + fieldData; 

if (pSM->m bLOVPickList) 
{ 

// 

// Convert LOV Val to Name 

// 

DOCHILD (m_pModel, 

GetLovValName (oldFieldData, pSM->m_LOVTypeValue, fieldData)); 

else 

fieldData « oldFieldData; 
AddQuotes (fieldData, • ■ ' ) ; 
// ) AND ( [From State Name] = fieldData 

searchSpec p ) AND ((From State Name] = " + fieldData; 

if (pSM->m bLOVPickList) 
I 

// 

// Convert LOV Val to Name 
// 

DO CHILD <m_pModel, 

GetLovValName (newFieldData, pSM->m_LOVTypeValue, fieldData)); 

else 

fieldData - newFieldData; 
AddQuotes (fieldData, • ■ ■ ) 
// ) AND ( [To State Name] - fieldData 

searchSpec ") AND ({To State Name] e» ■ ♦ fieldData; 

searchSpecRT *» searchSpec ♦ ■ ) " ; 

fieldData = GetPositionld () ; 
AddQuotes (fieldData, • " • ) ; 

// ) AND (([Public Flag) » "Y" ) OR (EXISTS ([Position Id) » fieldData))) 
searchSpec °) AND (({Public Flag] - \"Y\")"; 

searchSpec += " OR (EXISTS ([Position Id] » « ♦ fieldData +")))"; 
// 

// Set Named Search 
// 

DOCHILD (m_pBCTransition, SetNamedSearch ("State Transition", searchSpec)); 
DOCHILD (mjpBCTransition, Execute (FALSE, FALSE, TRUE)); 
DOCHILD (mjpBCTransition, Home () ) ; 
if (m_pBCTransition->CheckAct iveRow () == OK) 
// 

// Valid transition, now validate the rule 
// 

// 
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// Get the simple rule expression data 
// 

DOCHILD <m_pBCTransition, FieldValue ("Rule Expression - Simple", ruleBxpr) ) • 
if (! ruleExpr. I sEmpty () t& ! EvalBoolExpr (ruleExpr)) 

err = IDS_ERR_STATEjraANSITION_RULE_VALIDATION; 
errParmArray.Add (ruleExpr); 
errParmArray.Add (oldFieldData); 
errParmArray.Add (newFieldData) ; 
goto ll_abort; 

// 

// Get the rule expression data 

// 

DOCHILD (m_pBCTransition, FieldValue ("Rule Expression" . ruleExpr) ) • 
if (! ruleExpr. IsEmpty () .'EvalBoolExpr (ruleExpr)) 

err « IDS_ERR_STATEJTRANSITION_RULE_VALIDATION; 
errParmArray.Add (ruleExpr); 
errParmArray.Add (oldFieldData) ; 
errParmArray.Add (newFieldData) ; 
goto 11 abort; 
} " 

} 

else 
{ 

// 

// Check the "State Restrict Transition Flag" for this field 

// if Restrict Transition is not checked this state then return OK- 

// Otherwise current transtion is a Invalid transition 

if (HsRestrictTransition (pFieldName, oldFieldData)) 
searchSpecRT?^ 1 " 3 < ro -PBCTransition, SetNamedSearch ("State Transition". 

DOCHILD (m_pBCTransition, Execute (FALSE, FALSE, TRUE) ) • 
DOCHILD (m_pBCTransition, Home ()); 

if ( !m_pBCTransition->CheckActiveRow () =» OK) 

return (OK) ; 
else 

< 

DOCHILD (m_pBCTransition, FieldValue ("Public Flag", f ieldData) ) • 
if (f ieldData =» "Y") 
return (OK) ; 

} 

} 

// 

// Invalid transition 
// 

err « I DS_E RR_STATE_TRANS I T I ON_NO__ P R I VI LEG E ; 
errParmArray.Add (oldFieldData) ; 
errParmArray.Add (newFieldData); 
goto 11 abort; 

) 

} 



ll_abort : 

SetErrorMsg (err, errParmArray, pErrChild) 
return (err) ; 

} 



// 

// CSSBCBase: : EvalBoolExpr 
// 

// Purpose: 
// 



// 

// Returns TRUE if the logic of the expression is TRUE; Otherwise returns FALSE. 
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BOOL CSSBCBase : : EvalBoolExpr (CString strExpr ) 
{ 

ErrCode err ° OK; 

CSSObject* pErrChild = NULL; 

CSSDatum* pDatum o NULL; // Evaluate () result 

CSSRecord* pRecord; 

GetActiveRecord (pRecord) ; 

DO CHILD (m_pRuleExpr, Parse (strExpr)); 

DO CHILD (m_pRuleExpr, Evaluate (pDatum, pRecord, NULL) ) ; 

if (pDatum->IsKindOf ( RUNT I ME_CLAS S (CSS Bool) ) ) 
return ( * ( ( CSSBool * ) pDatum) ) ; 

ll_abort : 

SetErrorMsg (err, NULL, pErrChild) ; 
return (FALSE) ; 

} 

// 

// CSSBCBase: :CanDeleteUpdate 
// 

// Purpose: 
// 

// Check if we can perform the Delete on this record or Update on this field. 
ft 

BOOL CSSBCBase: .-CanSMDeleteUpdate (SMDeleteUpdate type, 

' LPCSTR pFieldName) 

ErrCode err = OK; 

CSSObject* pErrChild » NULL; 

if (!m_bS tat eModel) 
return (TRUE) ; 

if (m_mapS t at eModel .Get Count () > 0) 
{ 

POSITION posSM; 

CString strFieldName ; 

CString strStateNaroe; 

CString strFieldData; 

CString fieldData; 

StateModel* pSM = NULL; 

StateRestriction* pSR m NULL; 

if (type == SNUpdate) 
// 

// If current field is a state field then update is allowed 
// 

in_mapS t at eModel . Lookup ( pFieldName , ( COb j ect * & ) pSM ) ; 



} 



if (pSM) 

return (TRUE) ; 



for (posSM = m_mapSt at eModel. Get Start Posit ion () ; posSM; ) 

m_mapSt at eModel .GetNextAssoc (posSM, strFieldName, (CObject*&) pSM) ; 

FieldValue (strFieldName, strFieldData) ; 

if (pSM->m bLOVPickList) 
{ 

// 

// Convert LOV Val to Name 
// 

DOCHILD (m_pModel, 

GetLovValName (strFieldData, pSM- >m_LOVTypeValue , fieldData)); 
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} 

else 

fieldData = strFieldData; 

pSM->m_mapStateRestrict ion. Lookup {fieldData, (void*&) pSR) ; 
if (pSR) 

{ ■ * 

if (type « SMDelete) 

if (pSR- >mJt>RestrictDelete ) 
return (FALSE) ; 

else if (type ««= SMUpdate) 

if (pSR->ra_bRestrictUpdate) 
return (FALSE) ; 

else// if (type « SMDeleteOrUpdate) 

if (pSR->m_bRestrictDelete || 
pSR- >m_JbRestrictUpdate) 
return (FALSE) ; 

} } 



} 



ll_abort ; 

^ return (TRUE) ; 



// 

// CSSBCBase: IsRestrictTransition 
// 

// Purpose: 
// 

// Is the Restrict Transition Flag set for this field. 

BOOL CSSBCBase: : IsRestrictTransition (LPCSTR pFieldName , 
{ 



CString strFieldData) 



BrrCode err ■ OK; 

CSSObject* pErrChild - NULL; 

CString fieldData; 

if (!m_bStateModel) 
return (FALSE) ; 

if (m_mapStateModel.GetCount () > o) 

StateModel* pSM = NULL; 

StateRestriction* pSR » NULL; 

// 

// Is the Restrict Transition Flag set for this field. 

m_mapStateModel. Lookup (pFieldName, (CObject*&) pSM) ,- 
if (pSM->mJbLOVPickList) 
// 

// Convert LOV Val to Name 
// 

DOCHILD <ra_pModel, 
■ GetLovValName (strFieldData, pSM->m_LOVTypeValue, fieldData)) 

else 

fieldData « strFieldData; 
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pSM- >m_mapS tat eRestrict ion. Lookup (f ieldData, (void*&) pSR) ; 

if (pSR && pSR->m_bRestrictTransition) 
return (TRUE) ; 

} 

11 abort: 

"return (FAI*SE) ; 

} . 
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Appendix C - Sales Assistant Class Definition: 

5 '//""(///Hf/utn/u/ii/i/it/utiiiN/n/t/fiiiiit/niiniii/ruituui/iiii 

// bcactplan.h . Activity Plan Business Component core class 
// definitions 

10 't/ti//n/mt/ninnm//i/t//mu//,uuumtmimui//ii/uiti/tti/uii 

#ifndef BCACTPLAN H 

#def ine BCACTPLAN H 

15 #ifndef BCBASE_H 

# include "bcbase.h" 
#endif 

2Q class SS_EXPORT_CLASS CSSBCActivityPlan , public CSSBCBase 
SS_DECLARE__DYNCREATE (CSSBCActivityPlan) 



25 
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friend class CSSBusComp; 
friend class CSSBusObj ; 



protected : 

CSSBCActivityPlan (void) • 

virtual -CSSBCActivityPlan (void) ; 

30 virtual Errcode SqlSetFieldValue (LPCSTR pFieldName 

virtual Errcode GetPicKList C SS RSSS ' 

35 £££ ^^^tyre^late |SS? K*S5^! 1 

^ virtual Errcode RescheduleActivities (LPCSTR pFieldName, 

j . LPCSTR pNewFieldValue - NULL) ; 

#endif // _BCACTPLAN_H_ 



// bcaseess.h 



15 // bcassess * n : Sales Assistants - Assessment 

// FILE: bcassess.h 
// $Revision: 5 $ 



// $Revision: 5 $ 
#define Rpasspee u 



>U #define BCASSESS_H 

15 



#ifndef BUSCOMP_H 

# include ,, buscomp.h B 
#endif 



tfifndef BCBASE H 

# include "bcbase . h " 
#endif 

0 #ifndef ; SQLOBJ H 

#include "sqlobj.h" 
#endif 

class SS_EXPORT_CLASS CSSBCAssess Value : public CSSBCBase 
SS_DECLARE_DYNCREATE (CSSBCAssessValue) 

friend class CSSBusComp; 
f riend class CSSBusObj ; 

protected : 

CSSBCAssessValue (void) • 

virtual -CSSBCAssessValue (void) '; 

private: 
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ErrCode SumScore (void) ; 

public: 

virtual ErrCode SqlWriteRecord (void) ; 
virtual ErrCode SqlUndoRecord (void) ; 
virtual ErrCode SqlDeleteRecord (CSS Re cord* pRecord) ; 

}; 

class SS_EXPORT_SSEBCCLASS CSSBCAssess : public CSSBusComp 

SS_DECLARE_DYNCREATE (CSSBCAssess ) 

friend class CSSBusComp; 
friend class CSSBusObj ; 
protected : 

CSSBCAssess (void) ; 
virtual -CSSBCAssess (void) ; 

private : 

ErrCode CopyAt tributes (void) ; 

public: 

virtual ErrCode SqlWriteRecord (void) ; 
virtual BOOL CanUpdate (LPCSTR pFieldName) ; 

}; 

#endif // BCASSESS H 
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While the invention has been described with respect to certain preferred embodiments 
and exemplifications, it is not intended to limit the scope of the invention thereby, but 
solely by the claims appended hereto. 
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We claim: 

1. A method of preparing a state model defining the behavior of logical objects 
in a process model as a set of permitted states and a set of permitted transitions 
5 between the permitted states, and comprising the steps of: 

(1 ) selecting a template for the state model; 

(2) selecting business object components for the state model; 

(3) selecting or defining state transitions for the state model; 

(4) defining permitted state transitions from a "from state" to a 4 *to state" 
10 with a State Transition Rule name; 

(5) associating state transitions with state transition rules, names, and 
conditions; 

(6) enumerating the state transition names and state transition rule names; 
and 

15 (7) extracting the state transition rules from a database; wherein said 

states, transitions, and extracted rules comprise a state machine 
execution engine; and 
(8) processing a model through said state machine execution engine. 

20 2. The method of claim 1 wherein at least one of said state transition rules 
include prerequisites which must be met before the transition is permitted. 

3. The method of claim 1 wherein at least one of said state transition rules define 
authorized users for effecting a state transition. 

25 

4. The method of claim 1 wherein said objects are business objects that define a 
sales pipeline funnel model of a set of business deals. 

5. The method of claim 4 wherein said sales pipeline tunnel shows business deals 
30 being worked in different methodologies on a single sales pipeline graphic. 

6. The method of claim 5 wherein said methodologies are chosen from the group 
consisting of telesales process deals, strategic deals, and standard prooess 
deals. 
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7. The method of claim 5 comprising grouping business deals by sales 
methodology. 

5 8. The method of claim 5 comprising classifying deals. 

9. The method of claim 8 comprising classifying deals as qualifying deals, 
working deals, and closing deals. 

10 10. The method of claim 5 comprising creating a sales opportunity. 

1 1 . The method of claim 1 0 comprising creating a sales method. 

12. The method of claim 11 comprising breaking the sales method into sales 
15 cycles within the sales method. 

13. The method of claim 12 comprising breaking the sales cycles down into sales 
phases for each sales cycle. 

20 14. The method of claim 1 1 comprising associating a sales method with a sales 
opportunity. 

15. The method of claim 14 comprising advancing the sales opportunity based 
upon the associated sales method. 

25 

16. The method of claim 15 comprising sorting sales opportunities. 

17. The method of claim 16 comprising sorting and grouping sales opportunities 
by at least one of sales methods, cycles, and phases. 



30 



18. The method of claim 17 comprising passing the data, grouped by one or more 
of sales method, sales cycle, and deal phase, to a charting engine, and from the 
charting engine to the Sales Pipeline Funnel Chart. 
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19. The method of claim 1 further comprising monitoring the state of deal as it 
moves from state to state. 

20. The method of claim 19 comprising monitoring the state of a deal to determine 
5 additional actions with respect to the deal. 

21. The method of claim 19 comprising assigning activity and assessment 
templates to a deal in process. 

10 22. The method of claim 21 comprising assessing the deal using the assigned 
activity and assessment templates. 

23. A system running on at least one computer for preparing a state model 
defining the behavior of logical objects in a process as a set of permitted states and a 
15 set of permitted transitions between the permitted states, and said system configured 
to: 

(1) select a template for the state model; 

(2) select object components for the state model; 

(3) select or define state transitions for the state model; 

20 (4) define permitted state transitions from a "from state" to a "to state" 

with a State Transition Rule name; 

(5) associate state transitions with state transition rules, names, and 
conditions; 

(6) enumerate the state transition names and state transition rule names; 
25 and 

(7) extract the state transition rules from a database; wherein said states, 
transitions, and extracted rules comprise a state machine execution engine; and 

(8) process a model through said state machine execution engine. 

30 24. The system of claim 23 wherein at least one of said ^tate transition rules 
include prerequisites which must be met before the transition is permitted. 

25. The system of claim 23 wherein at least one of said -state transition rules define 
authorized users for effecting a state transition. 
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26. The system of claim 23 wherein said objects are business objects defining a 
sales pipeline funnel model of a set of business deals. 

5 27. The system of claim 26 wherein said sales pipeline funnel shows business 
deals being worked in different methodologies on a single sales pipeline 
graphic. 
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28. The system of claim 27 wherein said methodologies are chosen from the group 
consisting of telesales process deals, strategic deals, and standard process 
deals. 
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29. The system of claim 27 wherein the system is configured to grouping 
business deals by sales methodology. 

30. The system of claim 27 wherein the system is configured to classify deals. 

31. The system of claim 30 wherein the system is configured to classify deals as 
qualifying deals, working deals, and closing deals. 

32. The system of claim 27 wherein the system is configured to create a sales 
opportunity. 

33. The system of claim 32 wherein the system is configured to create a sales 
25 method. 

34. The system of claim 33 wherein the system is configured to break the sales 
method into sales cycles within the sales method. 

30 35. The system of claim 34 wherein the system is configured to break the sales 
cycles down into sales phases for each sales cycle. 

36. The system of claim 33 wherein the system is configured to associate a sales 
method with a sales opportunity. 
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37. The system of claim 36 wherein the system is configured to advance the sales 
opportunity based upon the associated sales method. 

5 38. The system of claim 37 wherein the system is configured to sort sales 
opportunities. 

39. The system of claim 38 wherein the system is configured to sort and group 
sales opportunities by at least one of sales methods, cycles, and phases. 



10 
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40. The system of claim 39 wherein the system is configured to pass the data, 
grouped by one or more of sales method, sales cycle, and deal phase, to a 
charting engine, and from the charting engine to the Sales Pipeline Funnel 
Chart. 

41 The system of claim 26 wherein the system is configured to monitor the state 
of deal as it moves from state to state. 



42. The system of claim 41 wherein the system is configured to monitor the state 
20 of a deal to determine additional actions with respect to the deal. 

43. The system of claim 41 wherein the system is configured to assign activity and 
assessment templates to a deal in process. 

25 44. The system of claim 43 wherein the system is -configured to assess the deal 
using the assigned activity and assessment templates. 
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